PocketDING
==========

Dieses Programm ist eine PDA-Version von Ding (http://www-user.tu-chemnitz.de/~fri/ding/).
Es sucht einen eingegebenen Begriff in einer Wrterbuchdatei und zeigt smtliche Eintrge
an, die ihn beinhalten.


Installation (der Anwendung und des Wrterbuchs Deutsch-Englisch)
-----------------------------------------------------------------

Whlen Sie eine der drei nachfolgenden Vorgehensweisen, um das Programm zu installieren:

- Verbinden Sie den PDA mit Ihrem PC und fhren Sie PocketDING-Setup.exe auf Ihrem PC aus;
  das Programm wird daraufhin auf dem PDA im Programme-Ordner installiert.
- Oder ffnen Sie PocketDING.CAB auf dem PDA; das Programm wird daraufhin auf dem PDA im
  Programme-Ordner installiert.
- Oder kopieren Sie PocketDING.exe auf den PDA und richten Sie ggf. manuell im Startmen
  eine Verknpfung zum Programm ein.

ACHTUNG! Das Programm bentigt eine Wortliste, die unter folgender Adresse im Internet zum
Download angeboten wird:

  http://ftp.tu-chemnitz.de/pub/Local/urz/ding/de-en/

Die Wortliste sollte den Namen "de-en.txt" besitzen und sich im selben Verzeichnis wie
PocketDING.exe befinden. In diesem Fall wird beim Aufruf des Programms die Wortliste
automatisch gefunden und verwendet.

Wenn Sie die Wortliste lieber in einem anderen Ordner (z.B. auf der Speicherkarte)
ablegen wollen, dann mssen Sie im Programmverzeichnis (d.h. dort, wo sich PocketDING.exe
befindet) eine Konfigurationsdatei namens PocketDING.ini erstellen und diese geeignet
einrichten, beispielsweise indem Sie in ihr eine Zeile der Form

  DataBase = ...

einfgen und dabei anstelle von ... den Dateinamen samt Pfad zur Wortliste angeben.
Das knnte dann so aussehen:

  DateBase = \Storage Card\PocketDING\de-en.txt

(siehe auch unten: Abschnitt "Konfigurationsdatei").


Einrichtung weiterer Wrterbcher
---------------------------------

PocketDING lsst sich auch ber den Meneintrag "Datei::Einstellungen" konfigurieren,
ohne dass Sie die Konfigurationsdatei manuell anlegen und bearbeiten mssen. Fhren Sie
folgende Schritte aus, um ein neues Wrterbuch in PocketDING aufzunehmen:

1. bertragen Sie eine Wrterbuchdatei im DING-Format auf den PDA, und zwar in ein
   Verzeichnis, auf das mittels des Dateiauswahlfensters zugegriffen werden kann (z.B. auf
   die Speicherkarte; siehe auch unten: Abschnitt "Bekannte Probleme").

2. Starten Sie PocketDING und ffnen Sie das Dialogfenster "Einstellungen", indem Sie auf
   den Meneintrag "Datei::Einstellungen" klicken.

3. Bettigen Sie in der Karteikarte "Wrterbcher" die Taste "Hinzufgen" (bzw.
   "Wrterbuch hinzufgen") und whlen Sie die gewnschte Wrterbuchdatei aus (z.B.
   "de-en.txt"). Der Dateiname wird anschlieend an erster Stelle in der Wrterbuch-Liste
   angezeigt und ist markiert.

4. Wechseln Sie zu den anderen Karteikarten des Dialogfensters, um Einstellungen zur
   neuen Wrterbuchdatei festzulegen. Beispielsweise knnen Sie den in der
   Wrterbuch-Liste angezeigten (vorlufigen) Dateinamen (z.B. "de-en.txt") durch eine
   aussagekrftigere Bezeichnung (z.B. "Deutsch-Englisch") ersetzen, indem Sie die
   entsprechende Eintragung in der zweiten Karteikarte "Wrterbuch Details" ndern. Sie
   knnen dort auch einen Titel vergeben (z.B. "Wrterbuch Deutsch-Englisch"), der beim
   Starten des Programms und beim ffnen des Suchdialogs in der Meldungsleiste angezeigt
   wird.

5. Um das Dialogfenster schlieen zu knnen, mssen Sie wieder zurck zur ersten
   Karteikarte "Wrterbcher" wechseln (z.B. mittels der kleinen X-Taste rechts oben).
   Bettigen Sie die Taste "OK", um die genderte Konfiguration zu speichern, oder die
   Taste "Abbrechen", um sie zu verwerfen.

Sofern nicht die Taste "Abbrechen" bettigt wurde, verwendet PocketDING dasjenige
Wrterbuch, welches beim Schlieen der Dialogfensters "Einstellungen" in der
Wrterbuch-Liste markiert war. Beim nchsten ffnen des Dialogfensters "Einstellungen"
werden Sie bemerken, dass das aktuell von PocketDING verwendete Wrterbuch an erster
Stelle in der Wrterbuch-Liste steht und alle anderen Wrterbcher um eine Position nach
unten gerutscht sind. Hufig benutzte Wrterbcher siedeln sich somit vorrangig im oberen
Bereich der Liste an.

Zum schnellen Wechseln des Wrterbuchs ffnen Sie einfach das Dialogfenster
"Einstellungen" und machen Sie in der Wrterbuch-Liste einen Doppelklick auf das
gewnschte Wrterbuch. Das Dialogfenster schliet sich daraufhin, und PocketDING
verwendet von nun an bei der Suche das Wrterbuch, auf das der Doppelklick erfolgte.
Je nach der fr das ausgewhlte Wrterbuch geltenden Einstellung wird anschlieend
automatisch der Suchdialog geffnet.

ACHTUNG! Bitte stellen Sie sicher, dass PocketDING auf das Speichermedium schreiben darf
und dort ausreichend Speicherplatz verfgbar ist, wenn Sie Ihre Wrterbcher ber den
Meneintrag "Datei::Einstellungen" verwalten. Wird beim Speichern der Einstellungen ein
Fehler gemeldet, dann liegt das mglicherweise an mangelndem Speicherplatz oder einem
bestehenden Schreibschutz.


Verwendung von LingoPad-Wrterbchern
-------------------------------------

Wenn Sie das Programm LingoPad (http://www.ego4u.de/de/lingopad) auf dem PC installiert
haben, dann knnen Sie dessen (beispielsweise mittels des Meneintrags "Wrterbcher::
Wrterbcher verwalten..." eingerichtete) Wrterbcher auch mit PocketDING verwenden.
In dem Unterverzeichnis "data" des Ordners, in dem LingoPad installiert ist, bzw. des
im Einstellungsdialog des LingoPad-Programms angegebenen Verzeichnisses fr Daten und
Einstellungen existieren zu jedem Wrterbuch drei Dateien, und zwar jeweils vom Typ TDB,
TX1 und TX2; meist ist aus dem Dateinamen ersichtlich, um welches Wrterbuch es sich
handelt. Kopieren Sie die gewnschte Datei vom Typ TDB auf den PDA und gehen Sie dann so
vor, wie oben im Abschnitt "Einrichtung weiterer Wrterbcher" ab Schritt 2 beschrieben.

Wenn Sie im obigen Schritt 3 eine Datei vom Typ TDB auswhlen, dann wird in der zweiten
Karteikarte "Wrterbuch Details" automatisch der Typ "LingoPad" eingestellt. Da DING-
und LingoPad-Format einander sehr hnlich sind, kann PocketDING die Konvertierung des
Dateiinhalts zum DING-Format zur Laufzeit vornehmen, ohne dass sich dies wesentlich auf
die Suchgeschwindigkeit auswirkt. Bitte beachten Sie die Nutzungs- und Lizenzbestimmungen,
wenn Sie LingoPad-Wrterbcher mit PocketDING nutzen; originale und modifizierte Versionen
von Wrterbchern, die unter der GNU General Public License (GPL) stehen, drfen i.d.R.
frei verwendet, verndert und weitergegeben werden.

ACHTUNG! Gehen Sie mit Bedacht vor, wenn Sie in der zweiten Karteikarte "Wrterbuch
Details" des Dialogfensters "Einstellungen" den Typ einstellen. PocketDING funktioniert
mglicherweise nicht richtig, wenn die Wrterbuchdatei nicht dem eingestellten Typ
entspricht.


Konvertierung anderer Wrterbcher ins DING-Format
--------------------------------------------------

Mit dem separat erhltlichen Windows-Programm ConvDING knnen Sie CSV/Excel-Dateien sowie
FreeDict- und StarDict-Wrterbcher in das DING-Format konvertieren (http://freedict.org/,
http://stardict.sourceforge.net). Derart konvertierte Dateien knnen dann von PocketDING
oder LingoPad verwendet werden.


Tipps und Tricks zu Wrterbucheinstellungen
-------------------------------------------

Die Einstellungen zu einem Wrterbuch lassen sich ndern, indem Sie das Dialogfenster
"Einstellungen" ffnen, das gewnschte Wrterbuch in der Wrterbuch-Liste markieren (erste
Karteikarte) bzw. mittels des Kombinationsfeldes auswhlen (brige Karteikarten) und in
den jeweiligen Karteikarten des Dialogfensters die nderungen vornehmen.

Wenn deutsche Umlaute und (nationale) Sonderzeichen im Suchergebnis nicht korrekt
angezeigt bzw. Suchbegriffe, die deutsche Umlaute oder (nationale) Sonderzeichen
enthalten, nicht gefunden werden, dann kann dies daran liegen, dass fr das ausgewhlte
Wrterbuch eine falsche Zeichenkodierung eingestellt ist. Manchmal hilft es, in der
zweiten Karteikarte "Wrterbuch Details" die Zeichenkodierung zu wechseln (beispielsweise
von UTF-8 nach ISO-8859-1). Davon unabhngig knnen Wrterbuchdateien aber auch Zeichen
enthalten, die auf einem PDA aufgrund seiner begrenzten Ressourcen nicht installiert sind
(siehe hierzu unten: Abschnitt "Ich sehe nur lauter Kstchen ...").

In der fnften Karteikarte "Sonstiges" knnen Sie die Option "Suchergebnis umgekehrt
anzeigen" aktivieren, wenn Sie die Sprachreihenfolge im Suchergebnis oder bei der Suche
umkehren mchten.

Die gettigten nderungen werden nur dann bernommen, wenn Sie den Suchdialog mittels der
Taste "OK" oder durch einen Doppelklick auf einen Eintrag der Wrterbuch-Liste schlieen
(in der ersten Karteikarte "Wrterbcher"). Die kleine X-Taste rechts oben ermglicht es
Ihnen, schnell zur ersten Karteikarte zurck zu gelangen.


Suche im Wrterbuch
-------------------

Der Menbalken enthlt die Eintrge "Datei" und "Suchen". Nach einem Klick auf "Suchen"
(oder alternativ: Enter-Funktion des Joysticks) ffnet sich ein Dialogfenster, in welchem
der zu suchende Begriff eingetragen und einige Suchparameter eingestellt werden knnen:

- Enthlt der Suchbegriff fhrende und abschlieende Leerzeichen, so werden diese beim
  Schlieen des Dialogfensters entfernt.
- Durch die Einstellung ">>", "<>" oder "<<" wird die Suchrichtung bestimmt: Erstere sucht
  den Begriff nur in der Ausgangssprache, letztere nur in der Zielsprache.
- Ist die Option "Zeilenanfang" aktiviert, so werden im Suchergebnis nur die Treffer
  angezeigt, in denen der gesuchte Begriff am Zeilenanfang steht.
- Ist die Option "Wortanfang" aktiviert, so werden im Suchergebnis nur die Treffer
  angezeigt, die ein Wort beinhalten, welches mit dem gesuchten Begriff beginnt.
- Ist die Option "Wortende" aktiviert, so werden im Suchergebnis nur die Treffer
  angezeigt, die ein Wort beinhalten, welches mit dem gesuchten Begriff endet.
- Ist die Option "Gro-/Kleinschreibung" aktiviert, so wird bei der Suche die Gro- und
  Kleinschreibung beachtet, d.h. im Suchergebnis werden nur die Treffer angezeigt, in
  denen der Begriff hinsichtlich der Gro- und Kleinschreibung exakt so geschrieben ist,
  wie er eingegeben wurde. Andernfalls ist die Gro- und Kleinschreibung nicht von
  Bedeutung.
- Durch das Aktivieren von sowohl "Wortanfang" als auch "Wortende" erreicht man, dass im
  Suchergebnis nur die Treffer angezeigt werden, in denen der gesuchte Begriff als
  eigenstndiges Wort vorkommt.
- Sind sowohl "Zeilenanfang" als auch "Wortanfang" aktiviert, so werden auch Treffer
  angezeigt, in denen dem gesuchten Begriff ein Semikolon voransteht.
- Das mit "Max. Anzahl von Treffern" betitelte Eingabefeld akzeptiert nur numerische
  Eingaben bis zu einem Wert von 9999. Es ist i.A. nicht sinnvoll, hier einen zu groen
  Wert einzutragen. Stattdessen sollte man lieber die Optionen "Zeilenanfang",
  "Wortanfang", "Wortende" oder "Gro-/Kleinschreibung" aktivieren bzw. eine Suchrichtung
  festlegen, um die Ergebnismenge auf die wirklich relevanten Eintrge einzugrenzen, falls
  eine Suche ohne diese Einschrnkungen zu viele Treffer liefert.

Nach Bettigung der Taste "Suchen" werden das Dialogfenster geschlossen und der
eingegebene Begriff in der Wrterbuchdatei gesucht. Noch whrend die Suche luft, werden
bereits erste Treffer im Ausgabebereich des Hauptfensters aufgelistet. Fr die Dauer der
Suche werden im Menbalken der Eintrag "Datei" deaktiviert und der Eintrag "Suchen" in
"Abbrechen" umbenannt. Durch einen Klick auf "Abbrechen" (oder alternativ: Enter-Funktion
des Joysticks) kann die Suche vorzeitig beendet werden. Die Suche bricht automatisch
vorzeitig ab, wenn die Anzahl der Treffer den im Suchdialog eingestellten Maximalwert
erreicht oder der programminterne Ausgabepuffer keine weiteren Zeichen mehr aufnehmen
kann.

Das Suchergebnis ist folgendermaen formatiert:

- Deutsche und englische Texte werden jeweils abwechselnd angezeigt, wobei die englischen
  Texte kursiv geschrieben und eingerckt sind.
- Die Treffer sind farblich gruppiert. Meist sind Flexionen, Singular/Plural-Kombinationen
  oder anderweitig thematisch zusammengehrende Ausdrcke in einer Gruppe zusammengefasst.
- Innerhalb einer Gruppe kommt der gesuchte Begriff mindestens einmal vor. Die Vorkommen
  sind in fetter Schrift hervorgehoben.

Im Suchergebnis vorkommende Abkrzungen sind brigens hier erlutert:

  http://dict.tu-chemnitz.de/de-en/abb.de.html


"Ich sehe nur lauter Kstchen ..."
----------------------------------

Wegen begrenzter Ressourcen sind auf einem PDA normalerweise nicht alle Schriftzeichen
der Welt vorinstalliert. Fr jedes Zeichen, das Ihr PDA nicht darstellen kann, wird
stattdessen in dem von PocketDING ausgegebenen Suchergebnis ein kleines Rechteck
angezeigt. Insbesondere auf PDAs, die auerhalb Asiens verkauft werden, tritt es bei
Verwendung von Wrterbchern mit asiatischem Wortschatz hufig auf, dass Kolonnen von
Rechtecken im Suchergebnis stehen, nicht aber ein einziges asiatisches Zeichen.

Das Nachrsten eines PDAs um asiatische Zeichenstze ist mitunter nicht so ganz einfach.
Zunchst einmal mssen Sie sich von irgendwoher eine Zeichensatz-Datei beschaffen,
welche die bentigten (Unicode)-Zeichen enthlt; diese Datei muss auf dem PDA in das
Windows-Verzeichnis kopiert werden bzw. in dessen Unterordner "Schriftarten". Danach
mssen Sie das Betriebssystem dazu bewegen, von nun an den neuen Zeichensatz zur
Darstellung zu verwenden; dies erfordert i.d.R. manuelle nderungen an der
Registrierungsdatenbank (Windows Registry) und/oder eine Modifikation der Datei
\Windows\wince.nls (National Language Support). Detailliertere Informationen zu diesem
Thema sind (in diversen Foren) im Internet zu finden.

Einen recht bequemen Weg der Nachrstung gibt es fr japanische und chinesische Zeichen:
Hierfr werden im Internet Installationspakete namens LetsJapanNo5.zip, echinaNO5.zip und
fontpatch.cab zum Download angeboten, welche Ihnen die oben geschilderten Arbeiten
abnehmen. Ebenfalls erwhnenswert, aber leider nicht kostenlos erhltlich, sind die
Software-Anwendungen "CE-Star Suite" und "Monster Chinese", die nicht nur die Anzeige
sondern sogar die Eingabe chinesischer Zeichen ermglichen.

Es empfiehlt sich, vor der Installation neuer Programme auf jeden Fall den bestehenden
Inhalt des PDAs zu sichern (z.B. mittels Microsoft ActiveSync), damit sich bei Bedarf der
alte Zustand des Gerts wieder herstellen lsst!

Zur besseren Lesbarkeit asiatischer Zeichen lassen sich in der Karteikarte "Suchergebnis"
des Einstellungsdialogs die Schriftgre herauf setzen und die Darstellung der Zielsprache
in Kursivschrift abschalten.


Die Zwischenablage
------------------

Wird im Suchdialog der Stift/Stylus auf dem Eingabefeld fr den Suchbegriff fr lngere
Zeit gedrckt gehalten, so ffnet sich ein Popup-Men. Eine markierte Textpassage lsst
sich mittels der Meneintrge "Ausschneiden" und "Kopieren" aus dem Eingabefeld in die
Zwischenablage bertragen oder mittels "Entfernen" lschen. Umgekehrt kann durch
"Einfgen" ein in der Zwischenablage befindlicher Text an der aktuellen Cursor-Position
des Eingabefeldes eingefgt werden. All diese Operationen lassen sich natrlich auch mit
den gelufigen Tastenkrzeln Strg-X, Strg-C, Strg-V und der Rckschritttaste (Backspace)
ausfhren. Das Popup-Men enthlt ferner - durch einen Trennstrich abgesetzt - die bis zu
5 letzten Sucheingaben. Nach dem Anklicken eines Suchbegriffs wird dieser in das
Eingabefeld bernommen. Beim Beenden des Programms mittels des Meneintrags
"Datei::Beenden" geht die Suchhistorie allerdings verloren.

Durch das Ziehen des Stiftes/Stylus lsst sich eine Textpassage im Suchergebnis markieren;
ein kurzes Antippen des Bildschirms oder Verschieben des Suchergebnisse mittels der
Laufleiste entfernt die Markierung wieder. Wird im Ausgabebereich der Stift/Stylus fr
lngere Zeit gedrckt gehalten, whrend eine Textpassage markiert ist, so ffnet sich ein
Popup-Men, welches Eintrge enthlt, um den markierten Text in die Zwischenablage zu
kopieren oder an den Notizzettel anzufgen (siehe nachfolgenden Abschnitt "Der
Notizzettel"). Wird der Suchdialog geffnet, whrend eine Textpassage markiert ist, so
wird der markierte Text automatisch in das Eingabefeld fr den Suchbegriff bernommen.


Der Notizzettel
---------------

Der Notizzettel gibt einem die Mglichkeit, nachgeschlagene bersetzungen (bzw. Auszge
aus diesen) zu sammeln und zu einem spteren Zeitpunkt nochmals zu betrachten bzw. genauer
einzuprgen. Es handelt sich bei ihm um eine Textdatei, die sich im selben Verzeichnis wie
das aktuell ausgewhlte Wrterbuch befindet; der Name dieser Datei entspricht dem des
Wrterbuchs, jedoch um die Endung "_pad.txt" erweitert. Initial muss mittels des
Meneintrags "Datei::Notizzettel::Anlegen" eine leere Notizzettel-Datei angelegt werden;
danach lsst sich eine markierte Textpassage ber das Popup-Men des Ausgabebereichs an
den bestehenden Inhalt des Notizzettels anfgen. Nach Bettigung des Meneintrags
"Datei::Notizzettel::Anzeigen" wird der Inhalt der Notizzettel-Datei im Ausgabebereich des
Programms angezeigt; die Eintrge "Leeren" und "Lschen" des Mens "Datei::Notizzettel"
ermglichen es, die Datei zu leeren oder gar zu lschen.

Die Notizzettel-Datei liegt im DING-Format vor, d.h. sie besteht aus Textzeilen der Form
"<Quellsprache> :: <Zielsprache>". Wenn man eine Textpassage des Suchergebnisses an den
Notizzettel anfgen mchte, sollte man idealerweise die Markierung so setzen, dass sie
sich sowohl ber die Quellsprache als auch ber die Zielsprache erstreckt, also
beispielsweise eine vollstndige bersetzungszeile umfasst:

  Vogel {m}
    bird

Beginnt die Markierung im Bereich der Zielsprache (hier: "bird"), so setzt PocketDING
automatisch den Suchbegriff anstelle der Quellsprache ein; analog wird der Suchbegriff
anstelle der Zielsprache eingetragen, wenn die Markierung im Bereich der Quellsprache
endet (hier: "Vogel {m}").

PocketDING selbst bietet keine Mglichkeiten, den Inhalt der Notizzettel-Datei zu
bearbeiten; bei Bedarf knnen Pocket Word oder ein Texteditor hierfr verwenden werden.
Eigentlich sollte es jedoch so sein, dass man die im Notizzettel gesammelten bersetzungen
irgendwann einmal exportiert und dann den Inhalt der Notizzettel-Datei leert. Die
exportierten Daten knnen anschlieend in anderen Programmen weiter verwendet werden,
beispielsweise fr den Aufbau einer Vokabelliste.


Datenexport
-----------

Mit den Export-Funktionen von PocketDING (Meneintrag "Datei::Export") lsst sich der
augenblicklich angezeigte Inhalt des Ausgabebereichs als HTML- oder CSV-Datei exportieren.
Die HTML-Datei kann mit den blichen Internet-Browsern betrachtet werden, die CSV-Datei
mit einem gewhnlichen Texteditor oder einem Tabellenkalkulationsprogramm. Um eine
CSV-Datei beispielsweise in OpenOffice.org Calc zu importieren, ist wie folgt vorzugehen:

1. OpenOffice.org Calc starten.
2. Meneintrag "Datei::ffnen..." bettigen, Dateiname angeben sowie "Text CSV" als
   Dateityp auswhlen und dann die Datei ffnen.
3. Im Textimport-Dialogfenster den Zeichensatz einstellen, den auch das in PocketDING
   verwendete Wrterbuch benutzt (also entweder UTF-8 oder Westeuropa ISO-8859-1), ferner
   als Separator das Komma (,) sowie als Texttrenner das Anfhrungszeichen (") whlen und
   dann den Import durchfhren.

In anderen Tabellenkalkulationsprogrammen ist analog zu verfahren. Auf diese Weise kann
eine Tabelle erzeugt werden, die aus bersetzungen besteht, die man irgendwann einmal in
PocketDING nachgeschlagen hat; diese Tabelle lsst sich dann beispielsweise zum
Vokabeltraining einsetzen. Man knnte eine derartige Wortliste auch wieder als CSV-Datei
exportieren und diese mit dem separat erhltlichen Programm ConvDING in ein Wrterbuch
konvertieren, welches sich in PocketDING verwendet lsst und ausschlielich nur Begriffe
enthlt, die man irgendwann einmal nachgeschlagen hat (oder ein bestimmtes Thema
betreffen).


Sonstige Funktionen des Programms
---------------------------------

Das Hauptfenster der Anwendung besteht aus folgenden Komponenten:

- Meldungsleiste,
- Ausgabebereich,
- vertikale Laufleiste und
- Menbalken.

In der Meldungsleiste werden informative Meldungen ausgegeben, beispielsweise "Suche
luft: ...", "Suche beendet: ...", "Suche abgebrochen: ..." oder "Fehler: ...". Im
Ausgabebereich wird das Suchergebnis angezeigt. Besteht dieses aus mehr Zeilen als im
Ausgabebereich dargestellt werden knnen, so kann mit der vertikalen Laufleiste der
sichtbare Ausschnitt nach oben oder unten verschoben werden; alternativ kann der Joystick
nach oben oder unten gedrckt werden.

ber das Men "Datei" knnen folgende Funktionen erreicht werden:

- "Hilfe::ber PocketDING":
  ffnet ein Informationsfenster zum Programm.
- "Hilfe::Kurzanleitung":
  Zeigt im Ausgabebereich einen Hilfetext an. Ein im Ausgabebereich angezeigtes
  Suchergebnis wird dadurch berschrieben.
- "Einstellungen":
  Dient der Verwaltung und Einrichtung von Wrterbchern.
- "Notizzettel":
  Enthlt Meneintrge zum Einrichten, Anzeigen, Leeren und Lschen des Notizzettels.
- "Export::HTML":
  Exportiert den im Ausgabebereich angezeigten Text als HTML-Dokument.
- "Export::CSV":
  Exportiert den im Ausgabebereich angezeigten Text als CSV-Datei.
- "Beenden":
  Beendet das Programm.


Konfigurationsdatei
-------------------

Das Programm entnimmt seine Einstellungen einer Textdatei. Diese sollte PocketDING.ini
heien und sich im selben Verzeichnis wie das Programm PocketDING.exe befinden. Die Datei
enthlt Zeilen der folgenden Form:

  <Schlsselwort>=<Wert>

In dem obigen Ausdruck steht <Schlsselwort> fr eines der nachfolgenden Schlsselwrter
und <Wert> fr einen numerischen Wert oder eine Zeichenkette.

Folgende Schlsselwrter werden vom Programm erkannt:

- "CaseSensitive":
  Ein Wert ungleich 0 bewirkt, dass im Suchdialog die Option "Gro-/Kleinscheibung" als
  aktiviert voreingestellt wird.
- "DataBase":
  Dem Schlsselwort kann ein Pfad samt Dateiname zu einer Wrterbuchdatei zugewiesen
  werden. Andernfalls muss die Wrterbuchdatei den Namen "de-en.txt" besitzen und sich im
  selben Verzeichnis wie das Programm befinden. Enthlt der dem Schlsselwort zugewiesene
  Wert keinen umgekehrten Schrgstrich (\), dann wird ihm der Pfad zum Verzeichnis des
  Programms vorangestellt.
- "FontSize":
  Dem Schlsselwort kann ein Wert zwischen 8 und 24 zugewiesen werden, welcher die in der
  Meldungsleiste und im Ausgabebereich verwendete Schriftgre bestimmt.
- "LineBegin":
  Ein Wert ungleich 0 bewirkt, dass im Suchdialog die Option "Zeilenanfang" als aktiviert
  voreingestellt wird.
- "MaxHits":
  Dem Schlsselwort kann ein Wert zwischen 1 und 9999 zugewiesen werden, mit welchem das
  mit "Max. Anzahl von Treffern" betitelte Eingabefeld im Suchdialog initialisiert wird.
  Voreingestellt ist fr dieses Feld der Wert 99.
- "OpenDialog":
  Ein Wert ungleich 0 bewirkt, dass der Suchdialog beim Programmstart automatisch geffnet
  wird.
- "OutputFormat":
  Der Wert 1 bewirkt, dass im Suchergebnis die Hintergrundfarbe von Treffer zu Treffer
  nicht mehr alterniert. Erhhen Sie den gewnschten Einstellungswert um 2, wenn im
  Suchergebnis die Zielsprache nicht mehr kursiv dargestellt werden soll. Erhhen Sie den
  Einstellungswert um 4, um zu verhindern, dass die Zielsprache nicht mehr eingerckt
  wird.
- "SearchDirection":
  Der Wert 0 bewirkt, dass im Suchdialog die Einstellung "<>" vorausgewhlt wird; durch
  den Wert 1 wird ">>" und durch den Wert 2 wird "<<" als Suchrichtung voreingestellt.
- "StartMessage":
  Normalerweise werden beim Starten des Programms der Pfad samt Dateiname zur
  Wrterbuchdatei in der Meldungsleiste angezeigt. Wem das nicht gefllt, der kann dem
  Schlsselwort eine alternative Anfangsmeldung zuweisen.
  Text
- "SwitchLanguage":
  Der Wert 0 bewirkt, dass das Programm in englisch beschriftet wird; ist der Wert 1, dann
  wird das Programm in deutsch beschriftet. Die Voreinstellung fr die Sprache hngt von
  den Lndereinstellungen des PDAs ab. Erhhen Sie den gewnschten Einstellungswert um 2,
  wenn die Sprachreihenfolge im Suchergebnis gewechselt werden soll. Erhhen Sie den
  Einstellungswert um 4, wenn die Wrterbuchdatei nicht im UNICODE-Format vorliegt. Der
  Wert sollte keinesfalls hher als 7 sein, wenn die Wortliste im DING-Format vorliegt;
  andernfalls kann es zu Fehlfunktionen des Programms kommen. Addieren Sie jedoch 512 zum
  Wert, wenn die Wrterbuchdatei vom Typ TDB (LingoPad) ist.
- "WordBegin":
  Ein Wert ungleich 0 bewirkt, dass im Suchdialog die Option "Wortanfang" als aktiviert
  voreingestellt wird.
- "WordEnd":
  Ein Wert ungleich 0 bewirkt, dass im Suchdialog die Option "Wortende" als aktiviert
  voreingestellt wird.

Einzelne Zeilen der Konfigurationsdatei knnen gruppiert sein. Einer derartigen Gruppe
steht eine Zeile mit dem Ausdruck

  [<Name>]

voran, wobei sich anstelle von <Name> eine Zeichenkette befindet. Diese Strukturierung
wird verwendet, wenn Sie PocketDING mittels des Meneintrags "Datei::Einstellungen"
konfigurieren. In diesem Fall existiert dann zu jedem eingerichteten Wrterbuch in der
Konfigurationsdatei jeweils eine Gruppe.

Wenn Sie die Konfigurationsdatei mit einem Texteditor bearbeitet, sollten Sie beachten,
dass PocketDING standardmig davon ausgeht, dass der Inhalt dieser Datei im
ISO-8859-1-Format vorliegt. Falls Sie stattdessen die UTF-8-Kodierung verwenden, so muss
der Dateiinhalt mit der Zeichenfolge "#!UTF-8" beginnen! Wenn im Einstellungsdialog
Zeichen eingegeben werden, die sich nicht mittels ISO-8859-1 kodieren lassen (z.B. das
Euro-Whrungssymbol), dann speichert PocketDING die Konfigurationsdatei automatisch im
UTF-8-Format; andernfalls wird die bestehende Kodierung beibehalten.

Die Konfigurationsdatei muss nicht zwingend PocketDING.ini heien und sich in dem
Verzeichnis befinden, in dem PocketDING installiert wurde, denn der Pfad einschlielich
Name einer INI-Datei knnen dem Programm auch als Aufrufparameter bergeben werden. Dies
ist ntzlich, wenn das Programm mit mehreren Wrterbuchdateien betrieben werden soll.
In diesem Fall knnte man zu jeder Wrterbuchdatei eine Verknpfung erstellen, ber
welche sich das Programm mit der jeweils passenden INI-Datei aufrufen lsst. Enthlt der
Aufrufparameter Leerzeichen, so muss er in Anfhrungsstriche eingeschlossen werden. Das
Programms kann nicht in mehr als einer Instanz ausgefhrt werden; beenden Sie erst eine
bestehende Instanz mittels des Meneintrags "Datei::Schlieen", bevor Sie das Programm
erneut aufrufen.

ACHTUNG! Wenn Sie von jemandem PocketDING.exe zusammen mit PocketDING.ini erhalten haben
und das Problem haben, dass das Programm die Wrterbuchdatei nicht findet, dann prfen Sie
bitte, ob in PocketDING.ini eine falsche Pfadangabe eingetragen ist. Lschen Sie ggf. die
Konfigurationsdatei und richten Sie das Programm neu ein (siehe oben: Abschnitte
"Installation" und "Einrichtung weiterer Wrterbcher"; siehe auch unten: Abschnitt
"Portabilitt").


Portabilitt
------------

PocketDING verwendet nicht die Windows Registrierungsdatenbank (Registry), sondern legt
seine Einstellungen ausschlielich in einer Konfigurationsdatei ab. Auf folgende Dinge
mssen Sie achten, wenn Sie eine portable Installation von PocketDING (z.B. auf der
Speicherkarte) erzeugen wollen:

- Die Konfigurationsdatei sollte PocketDING.ini heien und sich im Anwendungsverzeichnis
  befinden, also dort, wo auch PocketDING.exe liegt.
- Die Wrterbuchdateien sollten sich ebenfalls im Anwendungsverzeichnis befinden. In
  diesem Fall braucht in der Konfigurationsdatei hinter dem Schlsselwort "DataBase=" nur
  der Dateiname zu stehen, d.h. die Angabe eines Pfades kann und sollte entfallen.


Bekannte Probleme
-----------------

Das Standarddialogfenster zum ffnen von Dateien gestattet nur den Zugriff auf ausgewhlte
Verzeichnisse. Wrterbuchdateien, die an anderen Orten liegen, lassen sich damit leider
nicht zur Wrterbuch-Liste hinzufgen. Im Internet wird das Programm "File Dialog Changer"
zum Download angeboten, welches mittels der DLL gsGetFile.dll diese betriebssystembedingte
Einschrnkung umgeht.

Die Zeilenumbrche eines im Ausgabebereich angezeigten Textes werden nicht neu berechnet,
wenn sich die Mae des Anwendungsfensters ndern (beispielsweise das Display von Portrait
auf Landscape umgestellt wird). Erst wenn eine neue Ausgabe erzeugt wird, werden die
genderten Bildschirmmae bercksichtigt.


hnliche Projekte und Software
------------------------------

- Ding [ http://www-user.tu-chemnitz.de/~fri/ding/ ]
- MacDING [ http://macding.sourceforge.net/ ]
- MobileDing [ http://www.sebastianbauer.info/index.php?page=mobileding ]
- LingoPad [ http://www.ego4u.de/de/lingopad ]
- BEOLINGUS [ http://dict.tu-chemnitz.de/ ]


Wrterbcher im Ding-Format
---------------------------

- Deutsch-Englisch [ http://ftp.tu-chemnitz.de/pub/Local/urz/ding/de-en/ ]
                   [ http://ftp.tu-chemnitz.de/pub/Local/urz/ding/de-en-devel/ ]
- Deutsch-Norwegisch [ http://macding.sourceforge.net/ ]
- Deutsch-Spanisch [ http://savannah.nongnu.org/projects/ding-es-de/ ]


Lizenz und Gewhrleistung
-------------------------

PocketDING ist freie Software und darf gem der GNU General Public License Version 2
(und spteren Versionen dieser Lizenz) weiter gegeben werden. Haftungs- und
Gewhrleistungsansprche seitens des Nutzers bestehen nicht. Details sind durch die
GNU General Public License geregelt: http://www.fsf.org/copyleft/gpl.html#SEC1

In Ergnzung zur obigen Lizenz darf ein jeder seinen eigenen Beitrag (z.B. eigenen
Programmcode), den er selbst in das PocketDING-Projekt eingebracht hat, auch in Werken
(z.B. Projekten, Anwendungen) verwenden, die unter anderen Lizenzen stehen, solange sich
dieser eigene Beitrag von Beitrgen anderer klar abgrenzen lsst und die freie Verwendung
von PocketDING und seines Quelltextes gem der GNU General Public License unberhrt
bleibt.


Homepage und Kontakt
--------------------

- http://freenet-homepage.de/martin_wehner/
- mailto:martin_wehner@freenet.de


Historie
--------
(siehe ReadMe.txt)
